// 定义包路径：该类属于 org.example.springboot.common 包
package org.example.springboot.common;

// 引入所需的类
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;

/**
 * 跨域配置类（CORS Configuration）
 * 用于解决前后端分离架构下的跨域请求问题。
 */
@Configuration
public class CorsConfig {

    /**
     * 配置并注册一个 CorsFilter Bean，用于全局处理跨域请求
     *
     * @return 返回配置好的 CorsFilter 实例
     */
    @Bean
    public CorsFilter corsFilter() {
        // 创建一个基于 URL 的 CORS 配置源对象
        // 用于为不同的 URL 路径注册不同的跨域配置
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();

        // 创建一个 CorsConfiguration 对象，用来定义跨域请求的规则
        CorsConfiguration config = new CorsConfiguration();

        // 设置允许的来源（Origin），"*" 表示允许所有来源（即任何域名、IP 或端口）
        // 如果生产环境，建议指定具体域名如 "http://localhost:8080" 提高安全性
        config.addAllowedOrigin("*");

        // 设置允许的请求头（HTTP Headers），"*" 表示允许所有请求头
        // 包括常见的 Content-Type、Authorization 等
        config.addAllowedHeader("*");

        // 设置允许的 HTTP 方法（GET、POST、PUT、DELETE 等），"*" 表示允许所有方法
        config.addAllowedMethod("*");

        // 将上述跨域规则应用到所有路径（/** 表示拦截所有请求路径）
        source.registerCorsConfiguration("/**", config);

        // 返回一个新的 CorsFilter 过滤器，它会将上面配置的规则应用于所有的 HTTP 请求
        return new CorsFilter(source);
    }
}
